home *** CD-ROM | disk | FTP | other *** search
/ Revista CD Expert 8 / Revista CD Expert nº 08 CD1.iso / Utilitarios / Programacao / MS-DOS Interrupt List / inter60f / INT2RTF.ZIP / INT2RTF.DOC < prev    next >
Text File  |  1997-07-07  |  6KB  |  117 lines
  1.  === Int2RTF Interrupt List Compiler v1.2 (C) 1996 Slava Gostrenko ===
  2.  
  3.  
  4.      Introduction.
  5.  
  6.      This  program  converts Ralf Brown's Interrupt List into Rich Text Format
  7. (.RTF)  file that may be further compiled with Microsoft Help Compiler such as
  8. HC31.EXE or HCW.EXE to make Windows Help (.HLP) file.
  9.  
  10.      Int2RTF  uses  hypertext  features of the Interrupt List. It is the first
  11. (and  the  only)  Interrupt  List  compiler that makes a real hypertext of the
  12. Interrupt  List.  It  is  made  possible due to an advanced pattern processing
  13. technique used in the compiler.
  14.  
  15.      Not  only it creates comprehensive indexes for all the topics in the list
  16. but it also allows users to add their own indexes to the help file.
  17.  
  18.  
  19.      Usage.
  20.  
  21.      Unpack  all the Interrupt List and Int2RTF files into one directory. Make
  22. sure  that  there  is  at  least 18Mb of free space left on the drive. You may
  23. need up to 23Mb of free space if you computer has less than 5Mb of RAM. Try to
  24. free  up  to 5Mb of XMS memory (BIOS provided XMS suites as well as the memory
  25. provided  by  himem  or any other XMS driver). The rest of the RAM may be used
  26. for  disk  caching  provided  by any disk cache driver or operating system you
  27. have.
  28.  
  29.      Note  that abovelisted requirements are derived for Int2RTF.EXE itself. I
  30. don't  know  what  are the requirements for Microsoft Help Compiler. I usually
  31. run HC31.EXE with 16Mb of RAM and more than 100Mb of free hard disk space. And
  32. once  I've  got  a low memory error message running HC31.EXE with only 30Mb of
  33. free  hard  disk  space.  But  it  happened  when I was trying to run HC31.EXE
  34. without  preliminarily prepared key-phrase table (.PH file). I guess it should
  35. run  Ok  with 30Mb of free hard disk space if you use key-phrase file supplied
  36. with Int2RTF.
  37.  
  38.      Int2RTF  is  a  protected  mode (DPMI) program. So it is assumed that you
  39. have  alredy  configured  RTM  (DPMI  Runtime  manager that comes with Borland
  40. Pascal).  In fact the actual configuration (with the help of DPMIInst program)
  41. is  required  if  you have a 286 class computer. Otherwise it is only required
  42. that RTM.EXE and DPMI16BI.OVL can be found using PATH environment variable.
  43.  
  44.      Run  Int2HLP.Bat. After a while it will create IntWin.RTF file. Then this
  45. file  will  be  passed  to  HC31.EXE  Microsoft Help Compiler. You should have
  46. HC31.EXE and its related files reachable via PATH environment variable. If you
  47. develop  under  windows you should already have Microsoft Help Compiler. It is
  48. not  supplied within Int2RTF package. Microsoft Help Compiler is not nessesary
  49. called  HC31.EXE. Int2RTF was tested witn HC31.EXE and HCW.EXE. It is HC31.EXE
  50. that  is  called  from within Int2HLP.Bat. And Int2HLP_.Bat calls HCW.EXE. Use
  51. Int2HLP_.Bat  if  you  have HCW.EXE. Edit Int2HLP.Bat or Int2HLP_.Bat if it is
  52. your intention to use another version of Microsoft Help Compiler.
  53.  
  54.      Microsoft  Help  Compiler should produce IntWin.HLP that is the help file
  55. you've been waiting for.
  56.  
  57.      Before  you  start  to use newly created help file please bother yourself
  58. with   copying  of  HintSrch.DLL  supplied  with  Int2RTF  into  your  windows
  59. directory.
  60.  
  61.      To use the help file in windows just double click on its name.
  62.  
  63.      IntWin.RTF  file  is  not  automaticly  deleted.  Delete it yourself when
  64. finished with Microsoft Help Compiler.
  65.  
  66.  
  67.      Note.
  68.  
  69.      Do not rename IntWin.HLP. HintSrch.DLL search engine will stop working if
  70. used  not  with  the file named IntWin.HLP. And it does not work with the help
  71. file  produced  by  HCW.EXE.  Use  Win95/WinNT  built-in help search engine to
  72. search within help file produced by HCW.EXE.
  73.  
  74.  
  75.      User defined idexes.
  76.  
  77.      To  define  your  own  index edit Int_Keys.Txt file. It is a list of user
  78. defined  key  words  that  are  used  for  indexing.  Each word in the list is
  79. searched  in  the  Interrupt  List topics. All the topics containing given key
  80. word  will  be  listed  in  the  separate  index  topic. The key word used for
  81. indexing will be the name of the topic.
  82.  
  83.      Int_Bold.Txt  file  is  the  list of the key words that will be displayed
  84. using bold font. You may edit this file too.
  85.  
  86.  
  87.      Technical notes.
  88.  
  89.      While  running Int2RTF creates 2 temporary files. Int2RTF.Swp is the main
  90. swap  file  for  virtual memory. Topics.Swp is the swap file for the Interrupt
  91. List  topics.  Temporary  files  are  deleted on the normal termination of the
  92. program.
  93.  
  94.      The   Incomplt.Log  file  is  a  log  of  the  ambiguous  search  pattern
  95. applications. Normaly you don't need this file.
  96.  
  97.      While  running Int2RTF displays it's current status and may display error
  98. messages.  I've  debugged Int2RTF to run well on the Interrupt List Release 51
  99. and  added  lots  of error checks to the program to make it easier to find the
  100. incompatabilities  of  the  compiler's  algorithms  and  new  releases  of the
  101. Interrupt  List.  So  let me know if you have a newer version of the Interrupt
  102. List that is compiled with errors.
  103.  
  104.  
  105.      E-Mail  me  anytime  you  wish  and  don't forget to visit my homepage at
  106. http://sunny.aha.ru/~gw/ (read http.www file included in this package)! ;-)
  107.  
  108.  
  109. Author:  Slava Gostrenko
  110. E-Mail:  gw@aha.ru
  111. WWW:     http://sunny.aha.ru/~gw/  <- Latest versions and info are here
  112. FidoNet: 2:5020/201.105, 2:5020/468.105
  113.  
  114.  
  115.      You can register on my page to get automatic notifications when Interrupt
  116. List or Int2RTF is updated.
  117.